home *** CD-ROM | disk | FTP | other *** search
/ SPACE 2 / SPACE - Library 2 - Volume 1.iso / apps / 131 / applic / dslide.doc < prev    next >
Text File  |  1987-04-17  |  9KB  |  216 lines
  1.    ========================================================================
  2.              Deluxe SlideShow           (c)1987 Advanced Software
  3.               by John Brochu                rev: March 21, 1987
  4.    ========================================================================
  5.  
  6.                        This program is NOT public domain,
  7.                      but may be distributed free of charge
  8.                 provided this doc file accompanies the program.
  9.  
  10.    ------------------------------------------------------------------------
  11.  
  12.         Deluxe SlideShow is an attempt to combine all the currently popular
  13.    ST  graphics  formats into one compact, but flexible slide show program.
  14.    The program includes support for NeoChrome, DEGAS, DEGAS compressed, and
  15.    Tiny  format  pictures.   Any  pic can be loaded and displayed on EITHER
  16.    monitor.   The low and med to hi-res conversions take a few seconds, but
  17.    the  results  are  very  pleasing  since a 16 (or 4 in the med-res case)
  18.    level dither table is used to represent the different color intensities.
  19.    Hi-res to med-res is the same conversion as used in PicSwitch 0.6 and is
  20.    almost instantaneous.
  21.  
  22.         The  user  has  full  control  over slide speed, titling, and slide
  23.    order  through  the  use  of  an  optional script file.  You can specify
  24.    multiple search paths and/or filenames with full wildcard support.
  25.  
  26.         o Neo, DEGAS, DEGAS compressed, & Tiny support
  27.         o Fully automatic res-switching
  28.         o Fully programmable
  29.         o Optional script files with separate mono & color scripts
  30.         o Optional titles
  31.         o Supports command line input, with wildcards
  32.  
  33.  
  34.  
  35.    ------------------------------------------------------------------------
  36.    File Formats
  37.    ------------------------------------------------------------------------
  38.  
  39.         DSLIDE.PRG  will  load  and  display  pics  with the following file
  40.    extenders:
  41.              NEO............ NeoChrome
  42.              PI1-3.......... DEGAS
  43.              PC1-3.......... DEGAS compressed
  44.              TNY or TN1-3... Tiny
  45.  
  46.         Color cycling is not supported at this time.
  47.  
  48.  
  49.  
  50.    ------------------------------------------------------------------------
  51.    Script Files
  52.    ------------------------------------------------------------------------
  53.  
  54.         DSLIDE  uses  a  fairly  complex search routine to quickly find the
  55.    desired  files  in the directory.  If a valid file is found that matches
  56.    the  search  path,  the  extender  is  first verified to be sure it is a
  57.    picture file.
  58.  
  59.         When  the  program  is run, the command line is first checked for a
  60.    valid  pathname  or  filename.   If one is found it is processed and the
  61.    slide show proceeds.  If not, then the current directory is searched for
  62.    one  of  three script files, depending on whether a color or mono system
  63.    is  used.  If color, "SLIDEC.LST" is loaded and processed; if mono, then
  64.    "SLIDEM.LST"   is  loaded.   If  neither  is  found,  the  default  file
  65.    "SLIDE.LST"  is  used.   This  allows  you  to  have different slideshow
  66.    configurations  for  color  &  monochrome on the same disk.  If all else
  67.    fails, the default path "#:*.*" is used as the search path, where '#' is
  68.    the current directory.
  69.  
  70.         Script  files  may  contain the following fields (all are optional,
  71.    and can be in any order), default settings are given in brackets:
  72.              NAME:     a flag to indicate whether to title the pics [no]
  73.              TIME:     delay between pics (in seconds) [0 secs]
  74.              PATH:     Pathname list [current directory]
  75.              FILE:     Filename list [all files]
  76.  
  77.         The  'NAME:'  field  is  a  character  string,  a 'Y', or 'y' first
  78.    character  indicates  the  pictures will be titled at the bottom center,
  79.    anything else will be taken as a 'no' (and this is the default).
  80.  
  81.         The  'TIME:'  field  is  a  numeric string specifying the number of
  82.    seconds  to  display each picture.  Note this is the actual time the pic
  83.    will  be  on-screen.   Unlike  most  other  slide  shows,  DSLIDE  takes
  84.    disk-access  time  into  account.   If the pic takes longer than this to
  85.    load, it will flip immediately after it is loaded.
  86.  
  87.         The  'PATH:'  field  consists of a list of pathnames to be searched
  88.    one after another.  If a full pathname is present (ie. "A:\PICS\*.PI1"),
  89.    then  that  is  the  search  path  used.  If a path is present without a
  90.    filename  ("A:\PICS\"),  then  the FILE list is scanned one at a time to
  91.    complete  the  full  pathname.   Wildcards  may  be used in the filename
  92.    only.
  93.  
  94.         The  'FILE:'  field  consists of a list of filenames (and filenames
  95.    ONLY,  paths  will  be  stripped,  ie.  "A:\PICS\*.PC?"  will be read as
  96.    "*.PC?")  to  be  processed  one  at  a  time.   Again,  you may include
  97.    wildcards or use full filenames.
  98.  
  99.         The field names MUST BE UPPER CASE and MUST CONTAIN THE COLON.
  100.  
  101.         Blank  lines  are  ignored,  and all text before the first field is
  102.    ignored, so that comments can be used at the start of a script file.
  103.  
  104.         The following is a sample script file:
  105.  
  106.    ---------cut here----------
  107.    This is a sample DSLIDE script file...
  108.    Any text before the first field is ignored!
  109.    TIME:
  110.    5
  111.    NAME:
  112.    yes
  113.    PATH:
  114.    c:\pics\*.tny
  115.    c:\images\
  116.    #:
  117.    FILE:
  118.    *.p??
  119.    *.neo
  120.    *.tny
  121.    ----------cut here----------
  122.  
  123.         This  script  will  display  the  pics with a 5 sec delay, and with
  124.    titles.   The  first  PATH  entry  will cause all Tiny pics found in the
  125.    "pics"  folder  on  drive  C  to  be  displayed.   Since  this is a full
  126.    pathname,  the  file  list is ignored for this path, and the pathname is
  127.    searched  as-is.   After  this  is  complete  the  second  PATH entry is
  128.    processed.   Since it is a pathname only (no filename), each of the FILE
  129.    entries  in  turn  is  appended  to the path to form the complete search
  130.    pathname  (ie.  the  first path searched will be "c:\images\*.p??", then
  131.    "c:\images\*.neo",  and  finally "c:\images\*.tny").  Finally, the third
  132.    PATH  entry is processed, again since it is not a complete pathname, the
  133.    FILE list is scanned one at a time to complete the search pathname.  The
  134.    '#' character is used to denote the current drive (drive the program was
  135.    run from).
  136.  
  137.         Note  you  can  also specify the pics to display by name, in either
  138.    the  PATH  or  FILE fields, if you wish to display the pics in a certain
  139.    order, such as:
  140.  
  141.    -----------cut here-----------
  142.    PATH:
  143.    a:\pics\
  144.    FILE:
  145.    cat.pi1
  146.    house.pi1
  147.    dog.pi1
  148.    sketch.pi2
  149.    -----------cut here-----------
  150.  
  151.    or:
  152.  
  153.    -----------cut here-----------
  154.    PATH:
  155.    a:\pics\cat.pi1
  156.    a:\pics\house.pi1
  157.    a:\pics\dog.pi1
  158.    a:\pics\sketch.pi2
  159.    -----------cut here-----------
  160.  
  161.  
  162.  
  163.    ------------------------------------------------------------------------
  164.    The Command Line
  165.    ------------------------------------------------------------------------
  166.  
  167.         A  'PATH:' or 'FILE:' entry can also be entered on the command line
  168.    when  running  DSLIDE.   To do this, rename DSLIDE.PRG to DSLIDE.TTP, or
  169.    install  it as a Tos Takes Parameters application from the desktop.  You
  170.    can  also  install it with a certain file type and then display a single
  171.    pic at a time by double-clicking on the picture file's icon.
  172.  
  173.  
  174.  
  175.    ------------------------------------------------------------------------
  176.    Keyboard commands
  177.    ------------------------------------------------------------------------
  178.  
  179.         The  following  key  commands  are  accepted while the slideshow is
  180.    running:
  181.              SPACE......... pause at the current pic, any key resumes
  182.              RETURN, UNDO.. abort the show
  183.              ESC........... skip the time delay and flip to the next pic
  184.              HELP.......... toggle titles on/off
  185.              F1-F10........ change minimum pic display time as follows:
  186.                   F1..... 0 sec
  187.                   F2..... 1 sec
  188.                   F3..... 2 sec
  189.                   F4..... 4 sec
  190.                   F5..... 8 sec
  191.                   F6.... 15 sec
  192.                   F7.... 30 sec
  193.                   F8..... 1 min
  194.                   F9..... 2 min
  195.                   F10.... 4 min
  196.  
  197.         Holding down the right mouse button also aborts the slide show.
  198.  
  199.  
  200.  
  201.    ------------------------------------------------------------------------
  202.    Comments, anyone?
  203.    ------------------------------------------------------------------------
  204.  
  205.         This  program  was  written  mostly  because  I  was tired of using
  206.    several  different  slide show programs to display my growing library of
  207.    pics.   If  you like it or have some suggestions for future enhancement,
  208.    I'd  like  to  hear from you.  I can be reached on GEnie [JAKOB] and CIS
  209.    [70376,1235], or by mail at:
  210.  
  211.              Advanced Software
  212.              21 Northend Street
  213.              Peabody, MA  01923
  214.  
  215.    ========================================================================
  216.